To enable this, contact Vaultera Switch support. We will configure the domain on our end and provide a TLS certificate.
🔧 Setting Up a Custom Domain on Your Cloud
1. Identify Your DNS Provider
First, determine who manages your DNS records. This is typically your domain registrar, but it might be a different provider. If you’re unsure, you can find your DNS provider by running the following command in your terminal:yourdomain.com with your actual domain name. The output will list the name servers managing your DNS.
2. Create Required DNS Records
To link your custom domain to Vaultera switch, follow these steps:Step 1: Sign In to Your DNS Provider
Log in to your DNS provider’s control panel (e.g., GoDaddy, Cloudflare, AWS Route 53).Step 2: Navigate to DNS Settings
Locate the section where you can manage DNS records for your domain.Step 3: Create a CNAME Record
Create a new CNAME record to point your subdomain to Vaultera switch.| Field | Instructions | Description |
|---|---|---|
| Type | Select CNAME | Specifies the record type |
| Name | For paymentlink.xyz.com, enter paymentlink | The subdomain (prefix before the first dot) |
| Value | test.switch.vaultera.co | Points to the Vaultera Switch server (check if your provider requires a trailing dot) |
| TTL/Expiry | 300 | Sets the record to expire after 5 minutes |
Step 4: Create a TXT Record
This TXT record is required for domain ownership verification and TLS certificate provisioning.| Field | Instructions | Description |
|---|---|---|
| Type | Select TXT | Specifies the record type |
| Name | _acme-challenge.paymentlink | Used for certificate validation |
| Value | Paste the value provided by Vaultera Switch | A unique verification string |
| TTL/Expiry | 300 | A 5-minute expiration is sufficient |
Step 5: Verify Your CNAME Record
Run the following command to verify the CNAME record:Step 6: Verify Your TXT Record
Check that the TXT record has propagated:✅ What Happens Next?
Once your DNS records are correctly configured and verified, Vaultera Switch will validate your domain and provision it on our end. You will receive a confirmation email when the domain is ready to use.💳 Enabling Wallets (Apple Pay & Google Pay) with Custom Domains
To enable Apple Pay or Google Pay in payment links, you need to validate your custom domain with Apple or Google. This is necessary to:- Generate Apple Pay or Google Pay session tokens.
- Ensure the wallets work correctly in your payment link flow.
Steps:
- Set up your custom domain as described above.
- Obtain and register the respective Apple Pay or Google Pay certificates.
- Upload and configure these certificates within the Vaultera Switch dashboard.
Wallet support via payment links is only available when using custom domains due to domain-based validation requirements from Apple and Google.